Référence du langage de Script

Voici les commandes de script (par ordre alphabétique) :

ATTRIB BEEP COLLAPSE COMPARE COPY COPYTO CRITERIA DELETE EXPAND FILE-REPORT FILTER FOLDER-REPORT LOAD LOG MOVE OPTION RENAME REPORT SELECT SNAPSHOT SYNC TOUCH

ATTRIB (Attribut)

Utilisation :
attrib (+|-)<ensemble d'attribut 1> [(+|-)<ensemble d'attribut 2> <...>]

Met (+) ou enlève (-) l'ensemble d'attribut des items de la sélection courante.  Un ensemble d'attributs peut inclure comme attribut archive (a), système (s), caché (h), et lecture seule (r).

Exemples :
attrib +h
attrib +sh -a

BEEP (bip)

Utilisation :
beep

Bippe le haut-parleur du PC.

COLLAPSE (Compresse)

Utilisation :
collapse all
collapse <chemin d'accès> [<chemin d'accès> [...]]

Ferme tous les dossiers ou les dossiers des chemins d'accès spécifiés.  Les chemins d'accès sont relatifs au dossier de base et ne peuvent pas contenir de caractères génériques.

Exemple :
collapse "Dossier 1" Dossier2\SousDossier

COMPARE (Compare)

Utilisation :
compare [CRC|binary|rules-based]

Compare les contenus de la sélection courante en utilisant le type de comparaison.  Par défaut, le type de comparaison le plus récent est utilisé

Cette commande ne fait que comparer les fichiers une seule fois.  Pour changer comment les fichiers sont comparés après modification, utilisez criteria.

COPY (Copie)

Utilisation :
copy (lt->rt|rt->lt)

Copie les fichiers/dossiers sélectionnés dans la direction indiquée (lt = Gauche, rt = Droite).

COPYTO (Copie vers)

Utilisation :
copyto (lt|rt|all) [path:(relative|base|none)] <chemin d'accès>

Copie les fichiers/dossiers sélectionnés du côté spécifié vers le chemin spécifié en utilisant les options de chemin.  Par défaut, path:none est utilisé.

CRITERIA (Critères)

Utilisation :
criteria [attrib:<ensemble d'attributs>] [version] \
         [timestamp[:[#sec][;IgnoreDST]]] \
         [size|CRC|binary|rules-based] \
         [timezone:(ignore|(lt|rt)(+|-)<0..12>)]

Positionne tous les paramètres des critères de comparaison.

Exemple :
criteria attrib:sh timestamp:2sec;IgnoreDST rules-based timezone:lt+6

DELETE (Supprime)

Utilisation :
delete [recyclebin=(yes|no)] (lt|rt|all)

Supprime les fichiers/dossiers actuellement sélectionnés des côtés spécifiés;
recyclebin=yes : Déplace dans la corbeille, =no : Détruit;
lt = gauche, rt = droite, all = des deux côtés.

EXPAND (Étend)

Utilisation :
expand all
expand <chemin d'accès> [<chemin d'accès> [...]]

Ouvre tous les dossiers ou les dossiers des chemins d'accès spécifiés.  Les chemins d'accès sont relatifs au dossier de base et ne peuvent pas contenir de caractères génériques.  Les dossiers doivent être ouverts de telle façon que leur contenu puissent être utilisé avec d'autres commandes telles que select.

FILE-REPORT (Rapport de Fichier)

Utilisation :
file-report layout:<disposition> [options:<options>] \
            [title:<titre du rapport>] \
            output-to:(printer|clipboard|<nom de fichier>) \
            [output-options:<options>] [<nom de fichier 1> <nom de fichier 2>]

Génère un rapport de comparaison de fichier pour les fichiers sélectionnés actuellement.

Aussi bien file-report que folder-report doivent inclure une information vers où envoyer le rapport, et peuvent inclure une information additionnelle sur le format de sortie.

Exemples :
file-report layout:over-under options:display-context output-to:printer &
            output-options:print-color,wrap-word
file-report layout:patch options:ignore-all,patch-unified &
            output-to:"rapports\rapport.txt"

FILTER (Filtre)

Utilisation :
filter <masques de fichier>
filter cutoff:([<|>](<date heure>|#[days])|none)
filter attrib:((+|-)<ensemble d'attributs>|none)
filter size:([<|>]#[KB|MB|GB]|none)

Contrôle quels dossiers et quels type de fichiers seront comparés en utilisant le filtrage par nom (masques de fichier), le filtrage par date (cutoff) ou les autres filtrages (attrib ou size).

Exemples :
filter "*.pas;*.dpr;*.dfm"
filter cutoff:<7days
filter cutoff:>"Jan 1, 2001"
filter cutoff:"01/01/2001 12:00pm"
filter attrib:-sh
filter "*.txt;-Corbeille\" attrib:+r

FOLDER-REPORT

Utilisation :
folder-report layout:<disposition> [options:<options>] \
              [title:<titre du rapport>] \
              output-to:(printer|clipboard|<nom de fichier>) \
              [output-options:<options>]

Génère un rapport de comparaison de dossier pour les dossiers de base actuellement chargés.  Les dossiers sont montrés dans leur état courant.  Pour inclure les sous-dossiers, ajoutez une commande expand all ceci.

Exemples :
folder-report layout:side-by-side,column-size,column-version,column-timestamp &
              output-to:clipboard output-options:html-color
folder-report layout:xml output-to:"C:\Rapport de Dossier.xml"

LOAD (Charge)

Utilisation :
load <session>
load <chemin d'accès de gauche> [<chemin d'accès de droite>]
load <default>

Charge la session spécifiée, les dossiers de base spécifiés ou les Paramètres de la Session par Défaut (load <default>).  L'impossibilité de charger un dossier de base provoquera l'arrêt du script.

Exemples :
load MaSession
load c:\projet x:\projet

LOG (Journalise)

Utilisation :
log [none|normal|verbose] [[append:]<nom de fichier>]

Contrôle le niveau de détail du journal et où il est stocké.

MOVE (Déplace)

Utilisation :
move (lt->rt|rt->lt)

Déplace les fichiers/dossiers sélectionnés actuelle dans la direction spécifiée (lt = gauche, rt = droite).

OPTION (Option)

Utilisation :
option stop-on-error
option confirm:(prompt|yes-to-all|no-to-all)

Ajuste les options de traitement du script.

RENAME (Renomme)

Utilisation :
rename [regexpr <ancien masque>] <nouveau masque>

Réalise un renommage multi-fichier pour la sélection actuelle en utilisant le nouveau masque spécifié.  regexpr utilise un ancien masque pour effectuer un "Renommage via Expression Régulière".  Par défaut, un "Renommage DOS" est effectué.

REPORT (désapprouvé)

Cette commande a été désapprouvée et ne sera pas mise-à-jour pour supporter de nouvelle possibilité de rapport.  Utilisez FILE-REPORT ou FOLDER-REPORT à la place.

Utilisation :
report format:<format> \
       output:(<printer>|<clipboard>|<nom de fichier>)[;<options>] \
       [<nom de fichier 1> [<nom de fichier 2>]]

Produit un rapport de Comparaison de Dossiers ou un rapport de Différences de Fichier au format donné et l'envoie vers la destination spécifiée.  Les rapports de Comparaison de Dossiers utiliseront toujours les dossiers de base actuellement chargés.  Les rapport de Différences de Fichiers se rapporteront aux fichiers donnés, autrement, ce sera un rapport pour tous les fichiers sélectionnés.

Les différents codes de format sont listés ici.

Le rapport peut être dirigé vers l'imprimante par défaut, le presse-papier ou vers un fichier spécifique.  <printer> (imprimante) et <clipboard> (presse-papier) sont des mots-clés qui incluent les '<' et '>'.

Les options pour output:<printer> sont :
p mode portrait (défaut)
l mode paysage
c sortie colorée

Pour output:<clipboard> (sortie vers le presse-papier) ou output:<nom de fichier>, utilisez l'option h pour spécifier une sortie HTML.

Exemples :
load "C:\SiteWeb" "ftp://monsiteweb.com/"
report format:50n output:Rapport.html;h
report format:03d output:<printer> C:\Exemple\Fichier1.txt C:\Exemple\Fichier2.txt

SELECT (Sélectionne)

Utilisation :
select <masque de sélection 1> [<masque de sélection 2> <...>]

Sélectionne les contrôles sur lesquels les fichiers et les dossiers peuvent opérer.  Uniquement les fichiers et les dossiers qui correspondent au moins à un des masques de sélection font partie de la sélection.  Un masque de sélection est au format [<côté>.][<différence>.]<item>.

empty.folders (dossiers vides) est un masque de sélection spécial qui sélectionne les dossiers vides.

Exemples :
select lt.files rt.orphan.folders
select all

SNAPSHOT (Photographie)

Utilisation :
snapshot [save-crc][save-version][expand-archives][no-filters] \
         lt|rt|path:<chemin d'accès> [output:<cible>]

Sauvegarde un cliché en lecture seule du répertoire spécifié.

Exemples :
snapshot save-crc save-version no-filters path:C:\ output:D:\
snapshot lt output:"Copie Maison.bcss"

SYNC (Synchronise)

Utilisation :
sync [visible][create-empty] (update|mirror):(lt->rt|rt->lt|all)

Utilise le moteur de Synchronisation de Dossiers pour mettre à jour un couple de dossiers.  Cette commande n'utilise pas la sélection courante.

Exemple :
sync create-empty mirror:lt->rt

TOUCH (Touche, Modifie la date/heure)

Utilisation :
touch (lt->rt|rt->lt)
touch (lt|rt|all):(now|<date heure>)

Copie les dates/heures des fichiers d'un côté vers l'autre, ou positionne les dates/heures de tous les fichiers du côté spécifié à la date et à l'heure système courante (now) ou à la date/heure spécifiée.  Vous devez sélectionner des fichiers avant de pouvoir modifier leur date/heure.